schm-poscrm-papi

基础说明

本接口以资生堂POSCRM接口为基础，作为代理接口。

本接口省去资生堂POSCRM的鉴权步骤，调用时可直接使用明文参数调用。

本接口独有鉴权信息为header中带的client_id和client_secret，并作为调用方身份标识。

每个接口有独立的调用权限，如需使用请预先向管理员申请接口权限。

本文档详细描述了第三方系统开发者接入SCHM-POSCRM所需的接口开发规范。

本接口规范包括通用规范和业务规范。通用规范描述了所有接口必须遵守的公共部分，业务规范根据具体的业务交互内容描述了各个实际业务接口所需要的详细数据内容。

1. 接口通用规范

1.1 接口地址前缀

UAT地址（测试环境）: https://schm-api-test.shiseido.cn

PROD地址（生产环境）: https://schm-api.shiseido.cn

1.2 接口调用方式

接口统一使用HTTPS协议请求。实际请求地址如下：

[UAT地址 or PROD地址]/schm-poscrm-papi/{version}/{INTERFACE_URL}

其中，version参数目前统一传v2，INTERFACE_URL填入下方接口说明中的接口地址

举例，会员身份验证，其测试环境请求地址即为：https://schm-api-test.shiseido.cn/schm-poscrm-papi/v2/member/verify

1.3 权限说明

访问所有接口，都须在header中设置key为client_id和client_secret的参数。不同的接口调用方使用不同的参数。您需要向管理员申请认证信息。

例如：

client_id: fa98****3452
client_secret: 108b****41f2

接口会根据client_id进行鉴别权限。会分别对接口地址以及参数中的ownerId进行鉴权。

1. 请求地址鉴权：接口会通过clinet_id校验是否可以使用该接口。
2. ownerId鉴权：每个接口都会传一个参数：ownerId，这个参数含义为品牌ID。接口会通过client_id校验是否可以操作这个品牌。

1.4 业务参数说明

接口目前仅支持JSON格式。调用接口时，业务参数以POST形式提交。

建议在调用接口时添加如下header设置：

Content-Type=application/json

1.5 返回结果说明

接口返回结果会以明文形式直接返回。

接口返回结果的格式为JSON格式。

目录

• 2.1 会员身份验证
• 2.2 申请入会
• 2.3 会员绑定
• 2.4 修改会员资料
• 2.5 查询会员信息
• 2.6 注销会员
• 2.7 查询会员积分
• 2.8 查询会员当期积分履历
• 2.9 调整会员积分
• 2.10 兑换礼品后进行积分扣除
• 2.11 查询会员消费履历
• 2.12 查询会员等级信息
• 2.13 天猫会员绑定/解绑
• 2.14 接收天猫订单
• 2.15 查询会员购买里程信息(NARS)
• 2.16 查询会员可兑礼情况(NARS)
• 2.17 答谢活动礼品预约 (NARS)
• 2.18 答谢活动礼品兑换领取 (NARS)
• 2.19 更新会员隐私政策确认状态
• 2.20 第三方平台ID（如SFCCID）绑定
• 2.21 更新会员所属店铺及所属BC信息
• 2.22 更新会员标签
• 2.23 查询会员礼品及券
• 2.24 查询促销活动编号
• 2.25 批量添加活动对象
• 2.26 核销会员礼品申请或积分兑换预约
• 2.27 预约答谢活动礼品
• 2.28 申请领取试用礼品
• 2.29 取消领取试用申请
• 2.30 会员服务券预
• 2.31 核销会员的券码
• 2.32 批量查询会员券信息
• 2.33 会员券基本信息批量修改
• 2.34 批量发行券
• 2.35 会员设备绑定/解绑
• 2.36 查询会员绑定设备
• 2.37 查询设备订单信息
• 2.38 开具电子发票
• 2.39 门店库存查询接口
• 2.40 门店库存增减接口
• 2.41 店铺线上正向订单接入（下单）
• 2.42 店铺线上逆向订单接入（退货）
• 2.43 获取问卷基础信息
• 2.44 上传问卷结果信息
• 2.45 获取问卷调查结果
• 2.46 上传肌肤测试报告
• 2.47 查询肌肤测试报告
• 2.48 更新肌肤测试报告图片
• 2.49 上传肌肤测试信息
• 2.50 获取最近一次肌肤测试结果链接
• 2.51 店铺POS实时下单接口(正向）
• 2.52 数电发票-开票申请
• 2.53 数电发票-发票红冲

2. 接口说明

2.1 会员身份验证

接口地址: /member/verify
接口说明: 根据手机号/邮箱/WechatOpenId/WechatUnionId/会员卡号/天猫昵称/EC帐号验证是否CRM会员
接口名称: EC_MemberVerify
请求方式: HTTP POST 提交

2.1.1 参数说明

2.1.2 参数示例

{
    "OwnerId": "78",
    "UserId": "136XXXX1111",
    "UserIdType": "0",
    "MemberPassword": "xxxxxx"
}

2.1.3 返回结果说明

2.1.4 返回结果示例

{
  "ErrorCode": "",
  "Message": "",
  "MemberNo": "M7800000128"
}

2.2 申请入会

接口地址: /member/register
接口说明: 提交必要的信息注册会员。建议在开发阶段，注册会员成功后，再调用“查询会员信息接口”获取并验证注册的信息。
接口名称: EC_MemberRegist
请求方式: HTTP POST 提交

2.2.1 参数说明

2.2.2 参数示例

{
    "OwnerId": "78",
    "StoreId": "80100006",
    "Name": "张三",
    "Sex": "1",
    "BirthDay": "19870625",
    "Mobile": "19827382762",
    "Telephone": "19827382762",
    "MaritalStatus": "03",
    "ChildrenNumber": 2,
    "Address": "黄河路1号",
    "Zip": "200001",
    "Email": "aaa@bbb.com",
    "RegisteType": "80",
    "IsGetInfoByEmail": "1",
    "Memo": "备注信息XXXXXXXXXXXX",
    "Password": "123456",
    "RegisteCampaingTag": "H5"
}

2.2.3 返回结果说明

2.2.4 返回结果示例

{
  "ErrorCode": "",
  "Message": "",
  "MemberNo": "M7800000128"
}

2.3 会员绑定

接口地址: /member/bind
接口说明: 通过手机号或会员编号与公众号微信openid或UnionId进行绑定
接口名称: EC_MemberBind
请求方式: HTTP POST 提交

2.3.1 参数说明

2.3.2 参数示例

{
    "OwnerId": "78",
    "BirthDay": "19870625",
    "Mobile": "19827382762",
    "Email": "aaa@bbb.com",
    "Password": "XXXX"
}

2.3.3 返回结果说明

2.3.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "M7800000128"
}

2.4 修改会员资料

接口地址: /member/update
接口说明: 修改会员资料
接口名称: EC_MemberEdit
请求方式: HTTP POST 提交

2.4.1 参数说明

2.4.2 参数示例

{
    "OwnerId": "78",
    "StoreId": "80100006",
    "MemberNo": "M7800000128",
    "Name": "张三",
    "Sex": "1",
    "BirthDay": "19870625",
    "Mobile": "19827382762",
    "Telephone": "19827382762",
    "MaritalStatus": "03",
    "ChildrenNumber": "2",
    "Address": "黄河路1号",
    "Zip": "200001",
    "Email": "aaa@bbb.com",
    "IsGetInfoByEmail": "1",
    "Memo": "备注信息XXXXXXXXXXXX",
    "Password": "xxxx"
}

2.4.3 返回结果说明

2.4.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "M7800000128"
}

2.5 查询会员信息

接口地址: /member/query
接口说明: 通过会员号/手机号/邮箱/WechatOpenId/WechatUnionId/会员卡号/天猫昵称/EC 帐号查询会员信息
接口名称: EC_MemberInfoQuery
请求方式: HTTP POST 提交

2.5.1 参数说明

2.5.2 参数示例

{
    "OwnerId": "10",
    "StoreId": "",
    "MemberNo": "YZ008028",
    "IsReturnPoint": "1",
    "IsReturnTags": "1"
}

2.5.3 返回结果说明

2.5.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberInfo": {
        "OwnerId": "10",
        "StoreId": "00300023",
        "MemberNo": "YZ008028",
        "MemberName": "杨利芬",
        "Gender": "2",
        "Birthday": "19901201",
        "Mobile": "13599999999",
        "Telephone": "",
        "MaritalStatus": "03",
        "ChildrenNumber": "2",
        "Address": "",
        "Zip": "",
        "Email": "",
        "IsGetInfoByEmail": "0",
        "Memo": "",
        "Status": "10",
        "MemberType": "4",
        "RegisteType": "20",
        "Province": "001",
        "City": "001",
        "Point": "17200",
        "TmallNick": "",
        "RegisteDateTime": "2014-12-28T00:00:00",
        "FirstSaleDateTime": "2014-12-28T00:00:00"
    },
    "Tags": [{
        "TagId": "xxxxxx",
        "TagName": "xxxxxx"
    }, {
        "TagId": "xxxxxx",
        "TagName": "xxxxxx"
    }]
}

2.6 注销会员

接口地址: /member/cancelation
接口说明: 会员注销接口，只有CRM系统开启了注销功能才能成功调用。注销后，会员信息全部更改为“已注销”，手机号等信息全部更改为注销专用的无意义的数字
接口名称: CancelMember
请求方式: HTTP POST 提交

2.6.1 参数说明

2.6.2 参数示例

{
    "OwnerId": "10",
    "MemberNo": "M1000978773",
    "CancelType": "40",
    "CancelMemo": "Test"
}

2.6.3 返回结果说明

2.6.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.7 查询会员积分

接口地址: /point/query
接口说明: 根据会员号/手机号/邮箱/WechatOpenId/WechatUnionId/会员卡号/天猫昵称/EC 帐号查询会员当前可用积分和会员状态
接口名称: EC_MemberPointQuery
请求方式: HTTP POST 提交

2.7.1 参数说明

2.7.2 参数示例

{
    "OwnerId": "78",
    "MemberNo": "M7800000128"
}

2.7.3 返回结果说明

2.7.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "CurrentPointInfo": {
        "OwnerId": "78",
        "MemberNo": "M7800000128",
        "Point": "120",
        "Status": "10"
    }
}

2.8 查询会员当期积分履历

接口地址: /point/history
接口说明: 获取会员在当前积分期间的积分履历
接口名称: EC_MemberPointHistoryQuery
请求方式: HTTP POST 提交

2.8.1 参数说明

2.8.2 参数示例

{
    "OwnerId": "16",
    "StoreId": "32300000",
    "MemberNo": "M1600000XX"
}

2.8.3 返回结果说明

• Result

• 会员积分账期信息: PointHisHead

• 积分变动明细: GoodsDetail

2.8.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "PointHisHead": {
        "OwnerId": "16",
        "MemberNo": "XXX",
        "Status": "10",
        "BeginDate": "20140101",
        "EndDate": "20141231"
    },
    "GoodsDetailArray": [{
        "SaleDateTime": "20150102142356",
        "StoreId": "00300091",
        "StoreName": "东方商厦有限公司(GL)",
        "GoodsCode": "11114",
        "GoodsName": "资生堂新漾美肌 精华润肤乳",
        "SaleQty": "",
        "AfterSalesAmount": "",
        "AddPoint": "300",
        "PointIsActive": "",
        "AdjustReason": "",
        "AdjustReasonDesc": "",
        "ScoreActivityId": "",
        "ActivityName": ""
    }, ""]
}

2.9 调整会员积分

接口地址: /point/update
接口说明: 对会员积分进行调整
接口名称: EC_ScoreAdjust
请求方式: HTTP POST 提交

2.9.1 参数说明

2.9.2 参数示例

{
    "OwnerId": "10",
    "PeriodType": "1",
    "AdjustPoint": 4,
    "AdjustReason": "Test"
}

2.9.3 返回结果说明

2.9.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "M7800000128",
    "Point": ""
}

2.10 兑换礼品后进行积分扣除

接口地址: /point/add
接口说明: 在 EC 商城进行礼品兑换后直接调用本接口进行积分扣除。注意：本接口不是简单的积分调整扣减接口，是EC进行礼品兑换后将礼品信息和扣除的积分传递给CRM进行存储并扣减积分。兑换礼品的活动编号必须先在CRM创建。使用积分和 获取积分的交易明细不能混在同一个订单编号即小票号中。除非有特殊需求，否则不建议使用本接口，建议使用“礼品兑换接口”。
接口名称: EC_MemberPointAdd
请求方式: HTTP POST 提交

2.10.1 参数说明

2.10.2 参数示例

{
    "OwnerId": "78",
    "StoreId": "21700001",
    "MemberNo": "M7800000128",
    "PosId": 1,
    "BillNo": 1123456789,
    "AddPointSum": -200,
    "SaleDateTime": "20140909144323",
    "SalesDetailArray": [{
        "LineNo": 1,
        "GoodsCode": "88888888",
        "SaleQty": 1,
        "AddPoint": -200,
        "ScoreActivityId": ""
    }]
}

2.10.3 返回结果说明

2.10.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "M7800000128"
}

2.11 查询会员消费履历

接口地址: /sales/history
接口说明: 获取会员消费履历，仅包含购买或退货
接口名称: EC_GetMemberSalesHis
请求方式: HTTP POST 提交

2.11.1 参数说明

2.11.2 参数示例

{
    "OwnerId": "10",
    "MemberNo": "10",
    "DateFrom": "2020-01-01",
    "DateTo": "2022-01-01"
}

2.11.3 返回结果说明

• Result

• 消费记录： SalesArray

2.11.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "SalesArray": [{
        "MemberNo": "",
        "SaleDateTime": "",
        "GoodsName": "",
        "SalesAmount": "",
        "SaleQty": "",
        "BillNo": "",
        "StoreId": "",
        "StoreName": "",
        "AddPoint": "",
        "SalesType": "",
        "SalesTypeName": "",
        "PointIsActive": ""
    }]
}

2.12 查询会员等级信息

接口地址: /rank/query
接口说明: 获取会员等级信息（返回 10 天之内发生过的会员升降级信息的所有会员升降级履 历）
接口名称: EC_MemberRankChgQuery
请求方式: HTTP POST 提交

2.12.1 参数说明

2.12.2 参数示例

{
  "OwnerId": "78"
}

2.12.3 返回结果说明

• Result

• 会员等级集合：MemberRankArry

2.12.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "OwnerId": "78",
    "MemberRankArry": [{
        "MemberNo": "M7800000128",
        "MemberType": "02",
        "PrevMemberType": "02",
        "BeginDateTime": "20141201000000",
        "EndDateTime": ">20151130000000",
        "Status": "1"
    }]
}

2.13 天猫会员绑定/解绑

接口地址: /tmall/bind
接口说明: 通过手机号或会员编号与淘宝昵称进行绑定或解绑
接口名称: TM_MemberBind
请求方式: HTTP POST 提交

2.13.1 参数说明

2.13.2 参数示例

{
    "seller_name": "anessa 安热沙官方旗舰店",
    "mobile": "1730xxxx397",
    "type": "1",
    "member_nick": "quexxxxqin"
}

2.13.3 返回结果说明

2.13.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "M7800000128"
}

2.14 接收天猫订单

接口地址: /tmall/order
接口说明: 接收天猫订单数据
接口名称: PUSH_ORDERS
请求方式: HTTP POST 提交

2.14.1 参数说明

2.14.2 参数示例

[{
    "buyerNick": "安 xxxxXXXXX",
    "isPartConsign": false,
    "isDaixiao": false,
    "eticketExt": "",
    "receivedPayment": "376.00",
    "type": "fixed",
    "receiverCity": "内江市",
    "buyerFlag": 0,
    "nutFeature": "",
    "canRate": false,
    "receiverPhone": "",
    "creditCardFee": "375.75",
    "hasYfx": false,
    "price": "596.00",
    "serviceOrders": [],
    "payment": "376.00",
    "sellerRate": false,
    "hasPostFee": true,
    "adjustFee": "0.00",
    "pointFee": 0,
    "receiverZip": "516500",
    "is3D": false,
    "isBrandSale": false,
    "o2o": "",
    "stepTradeStatus": "FRONT_NOPAID_FINAL_NOPAID",
    "sendTime": "",
    "yfxFee": "",
    "receiverState": "四川省",
    "orders": [{
        "bindOid": 0,
        "ticketExpdateKey": "",
        "discountFee": "180.00",
        "buyerNick": "",
        "iid": "",
        "numIid": 564754520430,
        "buyerRate": false,
        "isDaixiao": false,
        "Num": 1,
        "shippingType": "express",
        "refundStatus": "WAIT_BUYER_RETURN_GOODS",
        "oid": 406361923684924655,
        "title": "ANESSA/安热沙王俊 xxxxxxx 防晒霜 60ml*2 户外军训",
        "itemMealId": 0,
        "isServiceOrder": false,
        "consignTime": "2019-04-11 18:26:23",
        "outerSkuId": "1033xxxx1900",
        "price": "596.00",
        "logisticsCompany": "芝麻开门",
        "outerIid": "1033xxxx900",
        "modified": "2019-04-11 18:26:23",
        "divideOrderFee": "376.00",
        "payment": "376.00",
        "sellerRate": false,
        "invoiceNo": "611062xxxxx25005",
        "skuPropertiesName": "化妆品净含量:120ml",
        "adjustFee": "0.00",
        "skuId": "37389xxxx898",
        "sellerNick": "",
        "itemMealName": "",
        "ticketOuterId": "",
        "timeoutActionTime": "2019/04/11 18:26:23",
        "isWww": false,
        "picPath": "https://img.alicdn.com/bao/uploaded/i4/2582702075/O1CN01DJ9DxxxxxxxxxxxxxxxeFP_!!0-item_pic.jpg",
        "totalFee": "416.00",
        "snapshotUrl": "o:406361923xxxxxxxxxx655_1",
        "partMjzDiscount": "40.00",
        "orderFrom": "WAP,JHS,WAP",
        "endTime": "2019-04-21 18:26:33",
        "sellerType": "B",
        "isOversold": false,
        "refundId": 0,
        "snapshot": "",
        "cid": 50011982,
        "status": "TRADE_FINISHED",
        "storeCode": ""
    }],
    "o2oGuideId": "",
    "snapshot": "",
    "buyerMemo": "",
    "realPointFee": 0,
    "status": "TRADE_FINISHED",
    "arriveInterval": 0,
    "iid": "",
    "yfxType": "",
    "sellerName": "上海 xx 贸易发展有限公司",
    "shippingType": "express",
    "buyerArea": "移动",
    "pccAf": 0,
    "sellerAlipayNo": "***ssa@ilarge.cn",
    "alipayWarnMsg": "",
    "alipayNo": "2019041122001xxxxxxxx027955266",
    "sellerFlag": 0,
    "markDesc": "",
    "receiverDistrict": "隆昌市",
    "rxAuditStatus": "",
    "stepPaidFee": "",
    "o2oDelivery": "",
    "yfxId": "",
    "sellerNick": "anessa 安热沙官方旗舰店",
    "serviceTags": [],
    "tradeMemo": "",
    "postFee": "0.00",
    "receiverMobile": "159xxxx5625",
    "buyerMessage": "",
    "areaId": "",
    "buyerObtainPointFee": 188,
    "expressAgencyFee": "0.00",
    "endTime": "2019/04/21 18:26:33",
    "discountFee": "40.00",
    "o2oOutTradeId": "",
    "payTime": "2019-04-11 14:55:51",
    "buyerEmail": "176xxxxx2@qq.com",
    "numIid": 564754520430,
    "buyerRate": false,
    "Num": 1,
    "tid": 406361923600000010101010,
    "consignTime": "2019/04/11 18:26:23",
    "sellerCodFee": "0.00",
    "isWt": false,
    "invoiceType": "",
    "modified": "2019/04/21 18:26:33",
    "tradeSource": "",
    "o2oShopName": "",
    "consignInterval": 0,
    "isLgtype": false,
    "Created": "2019/04/11 14:55:47",
    "sellerPhone": "021-58xxx550",
    "sellerEmail": "xxxxxx@ilarge.cn",
    "picPath": "https://img.alicdn.com/bao/uploaded/i4/2582702075/xxxxxxxxxxxxxxxxxxxxFP_!!0item_pic.jpg",
    "receiverAddress": "古湖街道跃进街 xxxxxxxxxxxx",
    "codStatus": "NEW_CREATED",
    "availableConfirmFee": "0.00",
    "sellerMemo": "",
    "invoiceName": "",
    "buyerAlipayNo": "***229422@qq.com",
    "alipayUrl": "",
    "title": "ANESSA 安热沙官方旗舰店",
    "zeroPurchase": false,
    "arriveCutTime": "",
    "codFee": "0.00",
    "asyncModified": "",
    "promotionDetails": [{
        "giftItemId": "",
        "promotionName": "聚划算",
        "discountFee": "180.00",
        "giftItemNum": "",
        "id": 406361923684924655,
        "promotionDesc": "聚划算:省 180.00 元",
        "giftItemName": "",
        "promotionId": "Tmall$saleJhs-3153345006_64404704774"
    }, {
        "giftItemId": "",
        "promotionName": "防晒品类购物券",
        "discountFee": "30.00",
        "giftItemNum": "",
        "id": 406361923684924655,
        "promotionDesc": "防晒品类购物券:省 30.00 元",
        "giftItemName": "",
        "promotionId": "coupon2category-8102904414_63456072279-944937124984"
    }, {
        "giftItemId": "",
        "promotionName": "直播优惠券",
        "discountFee": "10.00",
        "giftItemNum": "",
        "id": 406361923684924655,
        "promotionDesc": "直播优惠券:省 10.00 元",
        "giftItemName": "",
        "promotionId": "shopbonus-8174320787_64496096024-944978725031"
    }],
    "isForceWlb": false,
    "commissionFee": "24.06",
    "lgAgingType": "",
    "receiverName": "胡 XX",
    "lgAging": "",
    "timeoutActionTime": "1997/12/04 00:00:01",
    "alipayPoint": 0,
    "o2oGuideName": "",
    "sellerMobile": "139xxxx2723",
    "buyerCodFee": "0.00",
    "hasBuyerMessage": false,
    "tradeFrom": "WAP,JHS,WAP",
    "totalFee": "596.00",
    "o2oShopId": "",
    "snapshotUrl": "o:406361923xxxxx24655_1",
    "sellerCanRate": false,
    "alipayId": 0,
    "promotion": ""
}]

2.14.3 返回结果说明

2.14.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.15 查询会员购买里程信息(NARS)

接口地址: /mileage/info接口说明: 查询会员购买里程账户信息，仅限查询本期帐户信息。本接口仅限 NARS 品牌使用接口名称: EC_GetMemberMileageAccount请求方式: HTTP POST 提交

2.15.1 参数说明

2.15.2 参数示例

{
    "OwnerId": "10",
    "MemberNo": "YZ008028"
}

2.15.3 返回结果说明

2.15.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberMileageAccountData": [{
        "OwnerId": "10",
        "MemberNo": "YZ008028",
        "ExchangeRuleClassID": "C1",
        "TotalSaleQty": "6",
        "TotalRefundQty": "0",
        "TotalExchangedDeductQty": "5",
        "TotalExpiredQty": "0",
        "TotalValidQty": "1"
    }, {
        "OwnerId": "10",
        "MemberNo": "YZ008028",
        "ExchangeRuleClassID": "C2",
        "TotalSaleQty": "5",
        "TotalRefundQty": "0",
        "TotalExchangedDeductQty": "4",
        "TotalExpiredQty": "0",
        "TotalValidQty": "1"
    }, {
        "OwnerId": "10",
        "MemberNo": "YZ008028",
        "ExchangeRuleClassID": "C3",
        "TotalSaleQty": "1",
        "TotalRefundQty": "0",
        "TotalExchangedDeductQty": "0",
        "TotalExpiredQty": "0",
        "TotalValidQty": "1"
    }]
}

2.16 查询会员可兑礼情况(NARS)

接口地址: /mileage/query接口说明: 根据已选择的预约礼品及数量，返回剩余和兑换规则可预约的礼品数量。如果仅仅是查询会员当前各兑礼规则最新的可兑礼情况，请不要传递参数 “PresentReserveApplyDetail”节点信息。接口名称: EC_GetMemberCanExchangeAccount请求方式: HTTP POST 提交

2.16.1 参数说明

• 头部信息: PresentReserveApply

• 模拟礼品预约申请集合：PresentReserveApplyDetail

2.16.2 参数示例

{
    "PresentReserveApply": {
        "OwnerId": "10",
        "MemberNo": "YZ008029",
        "ActivityId": "100841-0010"
    },
    "PresentReserveApplyDetail": [{
        "PresentId": "10055",
        "ReserveNum": 1,
        "ExchangeRuleTypeId": "10"
    }, {
        "PresentId": "10055",
        "ReserveNum": 1,
        "ExchangeRuleTypeId": "10"
    }]
}

2.16.3 返回结果说明

• 可兑换礼品账户集合：MemberCanExchangeResultList

2.16.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberCanExchangeResultList": [{
        "ExchangeRuleTypeId": "10",
        "CanExchangeQty": "0"
    }, {
        "ExchangeRuleTypeId": "20",
        "CanExchangeQty": "0"
    }, {
        "ExchangeRuleTypeId": "30",
        "CanExchangeQty": "0"
    }, {
        "ExchangeRuleTypeId": "60",
        "CanExchangeQty": "1"
    }]
}

2.16.4 兑礼规则定义

10：脸部同品类满3件
20：眼部同品类满3件
30：唇部同品类满3件
40：面颊同品类满3件
50：指甲同品类满3件
60：跨品类满3件
70：全品类各满1件

2.17 答谢活动礼品预约 (NARS)

接口地址: /mileage/reserve接口说明: 答谢活动礼品预约申请处理接口名称: EC_NewPresentReserveApply请求方式: HTTP POST 提交

2.17.1 参数说明

• 礼品预约申请集合：PresentReserveApplyDetail

2.17.2 参数示例

{
    "PresentReserveApply": {
        "OwnerId": "10",
        "MemberNo": "M1000854113",
        "ActivityId": "100841-0002"
    },
    "PresentReserveApplyDetail": [{
        "PresentId": "10000C",
        "Qty": 2,
        "ExchangeRuleTypeId": "30"
    }, {
        "PresentId": "10000D",
        "Qty": 2,
        "ExchangeRuleTypeId": "40"
    }]
}

2.17.3 返回结果说明

2.17.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "ReserveApplyList": [{
        "ReserveId": "",
        "PresentId": "",
        "PresentName": "",
        "Qty": "",
        "ExchangeRuleTypeId": "",
        "ExchangeBeginDate": "",
        "ExchangeEndDate": ""
    }, {
        "ReserveId": "",
        "PresentId": "",
        "PresentName": "",
        "Qty": "",
        "ExchangeRuleTypeId": "",
        "ExchangeBeginDate": "",
        "ExchangeEndDate": ""
    }]
}

2.18 答谢活动礼品兑换领取 (NARS)

接口地址: /mileage/exchnange接口说明: 答谢活动礼品预约成功后到店兑换领取时，调用本接口进行兑换领取处理接口名称: EC_NewPresentExchange请求方式: HTTP POST 提交

2.18.1 参数说明

2.18.2 参数示例

{
    "OwnerId": "10",
    "PresentExchangeItems": [{
        "ReserveId": "8702001076263"
    }, {
        "ReserveId": "8702001076264"
    }]
}

2.18.3 返回结果说明

2.18.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.19 更新会员隐私政策确认状态

接口地址: /policy/update接口说明: 如果会员未确认过隐私政策，调用本接口更新为已确认，如果同时上传隐私政策确认签名文件则会将隐私政策确认状态更新为已上传确认签名文件接口名称: UpdatePolicyStatus请求方式: HTTP POST 提交

2.19.1 参数说明

2.19.2 参数示例

{
    "OwnerId": "10",
    "MemberNo": "XXX",
    "FileExtension": "JPG",
    "FileContent": "XXXXXXX",
    "IsConsented": 1
}

2.19.3 返回结果说明

2.19.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
  "MemberNo": ""
}

2.20 第三方平台ID（如SFCCID）绑定

接口地址: /platform/bind接口说明: 将第三方平台的用户 ID 与会员编号进行绑定接口名称: OtherPlatfrom_MemberBind请求方式: HTTP POST 提交

2.20.1 参数说明

2.20.2 参数示例

{
    "OwnerId": "10",
    "MemberNo": "XXXXXXXX000001",
    "OtherPlatfromType": "SFCC",
    "OtherPlatfromId": "XXXXXXXXXXXXXXXXX001"
}

2.20.3 返回结果说明

2.20.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.21 更新会员所属店铺及所属BC信息

接口地址: /bcandstore/update接口说明: 通过调用本接口来更新会员所属店铺和所属 BC 信息接口名称: UpdateMemberBCAndStore请求方式: HTTP POST 提交

2.21.1 参数说明

2.21.2 参数示例

{
    "OwnerId": "10",
    "MemberNo": "M1000450701",
    "StoreId": "32310000",
    "ServiceEmployeeNo": "00007674"
}

2.21.3 返回结果说明

2.21.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.22 更新会员标签

接口地址: /tag/update接口说明: 通过调用本接口来更新会员标签接口名称: EditMemberTag请求方式: HTTP POST 提交

2.22.1 参数说明

2.22.2 参数示例

{
    "OwnerId": "10",
    "TagId": "50001",
    "Action": "Add",
    "MemberList": ["0011000300008", "M1000450701"]
}

2.22.3 返回结果说明

2.22.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.23 查询会员礼品及券

接口地址: /gifts/detail接口说明: 查询会员礼品及券信息接口名称: EC_GetMemberGifts接口方式: HTTP POST 提交

2.23.1 参数说明

2.23.2 参数示例

{
    "OwnerId": "100010",
    "MemberNo": "",
    "PAType": "",
    "BeginTime": "2020-01-01",
    "EndTime": "2022-01-01",
    "PAStatus": ""
}

2.23.3 返回结果说明

• 礼品兑换信息集合：HistoryApplyArray

2.23.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "HistoryApplyArray": [{
        "ApplyDate": "",
        "GoodsCode": "",
        "OwnerID": "",
        "ApplyId": "",
        "MemberNo": "",
        "PAID": "",
        "PAType": "",
        "Qty": "",
        "ExchangeScore": "",
        "TicketSerialNo": "",
        "GoodsStatus": "",
        "TicketStatus": "",
        "TicketType": "",
        "GOODSNAME": "",
        "GOODSNAME_EN": "",
        "TicketBegYmd": "",
        "TicketEndYmd": "",
        "ExchangeStatus": "",
        "ExchangeDate": "",
        "ExchangeStoreId": "",
        "ExchangeStoreName": "",
        "ExchangeBeginDate": "",
        "ExchangeEndDate": "",
        "SaleDateTime": "",
        "IsExpress": "",
        "ExpressNo": "",
        "ExpressStatusCode": ""
    }]
}

2.24 查询促销活动编号

接口地址: /activity/query接口说明: 获取促销活动编号列表（第二天开始的所有活动）接口名称: EC_ScoreActivityQuery接口方式: HTTP POST 提交

2.24.1 参数说明

2.24.2 参数示例

{
  "OwnerId": ""
}

2.24.3 返回结果说明

• 活动明细: ActivityArray

• 活动明细: ScoreValueArray

2.24.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "OwnerId": "",
    "ActivityCount": "2",
    "ActivityArray": [{
        "ActivityId": "100452-015",
        "ActivityName": "双11活动",
        "ActivityDistinction": "10",
        "BeginDateTime": "20141111",
        "EndDateTime": "20141111",
        "Status": "30",
        "ScoreValueArray": [{
            "MemberType": "1",
            "ScoreValue": "1.5"
        }, {
            "MemberType": "2",
            "ScoreValue": "2.0"
        }]
    }]
}

2.25 批量添加活动对象

接口地址: /activity/batchadd接口说明: 通过调用本接口可以对指定的活动对象批量添加活动成员接口名称: AddMemberToActivity接口方式: HTTP POST 提交

2.25.1 参数说明

• 活动明细: MemberMstArray

2.25.2 参数示例

{
    "OwnerId": "10",
    "DMRecordId": "38",
    "MemberMstArray": [{
        "MemberNo": "M1000450701"
    }, {
        "MemberNo": "M1000450702"
    }]
}

2.25.3 返回结果说明

2.25.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.26 核销会员礼品申请或积分兑换预约

接口地址: /present/reserve接口说明: 核销会员的领取试用申请或积分兑换预约申请记录。核销后，领取试用申请状态为已领取，积分兑换预约状态为已兑换接口名称: PresentAndSampleTake接口方式: HTTP POST 提交

2.26.1 参数说明

2.26.2 参数示例

{
    "OwnerId": "78",
    "MemberNo": "XXX",
    "ApplyId": "XXXXXXXXXXXXXXXXXX",
    "PAType": "10"
}

2.26.3 返回结果说明

2.26.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.27 预约答谢活动礼品

接口地址: /present/exchange接口说明: 答谢活动做礼品预约申请接口名称: EC_PresentExchange接口方式: HTTP POST 提交

2.27.1 参数说明

2.27.2 参数示例

{
    "ActiveNo": "",
    "MemberNo": "",
    "GoodsArray": [{
        "GoodCode": "A001",
        "Qty": 1
    }, {
        "GoodCode": "A002",
        "Qty": 1
    }],
    "OwnerId": "",
    "Store": "",
    "OrderConsignee": {
        "Name": "",
        "Mobile": "",
        "Telephone": "",
        "Area_State": "",
        "Area_City": "",
        "Area_District": "",
        "Addr": ""
    }
}

2.27.3 返回结果说明

2.27.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "",
    "Score": "",
    "ReserveId": "",
    "ReserveDetails": [{
        "ReserveId": "",
        "GoodsCode": "",
        "Qty": ""
    }, {
        "ReserveId": "",
        "GoodsCode": "",
        "Qty": ""
    }],
    "Tickets": [{
        "GoodCode": "",
        "Ecode": ""
    }, {
        "GoodCode": "",
        "Ecode": ""
    }]
}

2.28 申请领取试用礼品

接口地址: /sample/apply接口说明: 会员进行领取试用活动的礼品进行申请接口名称: EC_SampleApply接口方式: HTTP POST 提交

2.28.1 参数说明

• 商品信息集合：GoodsArray

2.28.2 参数示例

{
    "OwnerId": "",
    "Store": "",
    "ApplyStore": "",
    "ActiveNo": "",
    "MemberNo": "",
    "GoodsArray": [{
        "GoodCode": "",
        "Qty": 0
    }, {
        "GoodCode": "",
        "Qty": 0
    }]
}

2.28.3 返回结果说明

2.28.4 返回结果示例

{
    "ErrorCode": "",
    "Message": "",
    "MemberNo": "",
    "ApplyId": ""
}

2.29 取消领取试用申请

接口地址: /sample/cancel接口说明: 通过本接口对指定的领取试用申请进行取消，取消后会员可以再重新进行申请接口名称: CancelSampleApply接口方式: HTTP POST 提交

2.29.1 参数说明

2.29.2 参数示例

{
    "OwnerId": "10",
    "ApplyId": "9106009076212"
}

2.29.3 返回结果说明

2.29.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.30 会员服务券预

接口地址: /coupon/reserve接口说明: 会员服务券预约申请，可以支持在已预约的基础上再做预约更新接口名称: MemberTicketReserve接口方式: HTTP POST

2.30.1 参数说明

2.30.2 参数示例

{
    "OwnerId": "78",
    "StoreId": "32300000",
    "MemberNo": "XXXX",
    "CouponSerialNo": "1000000000000001",
    "ReserveType": 1,
    "ApplyStoreId": "32300000",
    "ApplyDateTime": "2017-12-31T10:00:00",
    "ApplyMemo": ""
}

2.30.3 返回结果说明

2.30.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.31 核销会员的券码

接口地址: /coupon/consume接口说明: 核销会员券接口名称: EC_CouponConsume接口方式: HTTP POST 提交

2.31.1 参数说明

2.31.2 参数示例

{
    "OwnerId": "78",
    "StoreId": "32300000",
    "MemberNo": "XXX",
    "CouponSerialNo": "1000000000000001",
    "ConsumptionType": "70",
    "SaleStoreId": "32300000",
    "SalePosId": 1,
    "SaleBillNo": 255
}

2.31.3 返回结果说明

2.31.4 返回结果示例

{
    "ErrorCode": "",
    "Message": ""
}

2.32 批量查询会员券信息

接口地址: /coupon/query接口说明: 分页批量查询会员券信息。本接口于 2020-01-01 0:00 正式发布。每页返回500行，如果返回结果中HasNextPage=false，则说明当前页就是最后一页接口名称: EC_GetMemberTickets接口方式: HTTP POST 提交

2.32.1 参数说明